List bank

Get Bank

Service ini digunakan untuk melihat list kode bank dan nama bank

Service Info

HTTP Method	POST
Service Code	43
Http Method	POST
Path	.../v1.0/bank/list-bank
Authentication	OAuth 2.0

Header

Header Name	Tipe Data	Wajib	Deskripsi
Content-Type	String	Y	application/json
X-TIMESTAMP	String	Y	Waktu lokal klien saat ini yyyy-MM-ddTHH:mm:ss.SSSTZD format
X-PARTNER-ID	String	Y	Client’s client_id (diberikan pada saat onboarding )
X-CHANNEL-ID	String	Y	ID channel merchant
X-SIGNATURE	String	Y	Dibuat dengan algoritma asymmetric with token : Signature Generation
X-EXTERNAL-ID	String	Y	ID external merchant (tidak boleh sama di hari yang sama)

Body

Nama Field	Tipe Data	Wajib	Deskripsi
merchantId	String	Y	Kode unik yang dimiliki setiap merchant

JSON

{
  "merchantId": "121xxxx"
};

CURL

 curl --location --request POST '../v1.0/bank/list-bank' \
--header 'x-client-key: 6c57db4e-9e11-4951-9bcf-d6f177dafbcc' \
--header 'x-timestamp: 2024-01-16T10:54:21+07:00' \
--header 'x-signature: qrQQSSkvCXxYE3MWJpsn+loHuh4+1xlNWEF6oKmqJgbBJHYqnYoBAYgsv/+DXC7dMeGgdu2dkbXBuMQUD/cGZQ==' \
--header 'x-partner-id: 6c57db4e-9e11-4951-9bcf-d6f177dafbcc' \
--header 'channel-id:  23412' \
--header 'x-external-id: 2024-05-15T06:56:02.642Z' \
--header 'Content-Type:  application/json' \
--header 'Authorization: Bearer 6430fe8b-79d5-4e58-a337-6eb498e117a5' \
--data-raw '{
  "merchantId": "121xxxx"
}'

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => '../v1.0/bank/list-bank',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
  "merchantId": "121xxxx"
}',
  CURLOPT_HTTPHEADER => array(
    'x-client-key: 6c57db4e-9e11-4951-9bcf-d6f177dafbcc',
    'x-timestamp: 2024-01-16T10:54:21+07:00',
    'x-signature: qrQQSSkvCXxYE3MWJpsn+loHuh4+1xlNWEF6oKmqJgbBJHYqnYoBAYgsv/+DXC7dMeGgdu2dkbXBuMQUD/cGZQ==',
    'x-partner-id: 6c57db4e-9e11-4951-9bcf-d6f177dafbcc',
    'channel-id:  23412',
    'x-external-id: 2024-05-15T06:56:18.301Z',
    'Content-Type:  application/json',
    'Authorization: Bearer 6430fe8b-79d5-4e58-a337-6eb498e117a5'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

NODE JS

var request = require('request');
var options = {
  'method': 'POST',
  'url': '../v1.0/bank/list-bank',
  'headers': {
    'x-client-key': '6c57db4e-9e11-4951-9bcf-d6f177dafbcc',
    'x-timestamp': '2024-01-16T10:54:21+07:00',
    'x-signature': 'qrQQSSkvCXxYE3MWJpsn+loHuh4+1xlNWEF6oKmqJgbBJHYqnYoBAYgsv/+DXC7dMeGgdu2dkbXBuMQUD/cGZQ==',
    'x-partner-id': '6c57db4e-9e11-4951-9bcf-d6f177dafbcc',
    'channel-id': ' 23412',
    'x-external-id': '2024-05-15T06:56:45.081Z',
    'Content-Type': ' application/json',
    'Authorization': 'Bearer 6430fe8b-79d5-4e58-a337-6eb498e117a5'
  },
  body: '{
  "merchantId": "121xxxx"
}'

};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

GO

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "../v1.0/bank/list-bank"
  method := "POST"

  payload := strings.NewReader(`{
  "merchantId": "121xxxx"
}`)

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("x-client-key", "6c57db4e-9e11-4951-9bcf-d6f177dafbcc")
  req.Header.Add("x-timestamp", "2024-01-16T10:54:21+07:00")
  req.Header.Add("x-signature", "qrQQSSkvCXxYE3MWJpsn+loHuh4+1xlNWEF6oKmqJgbBJHYqnYoBAYgsv/+DXC7dMeGgdu2dkbXBuMQUD/cGZQ==")
  req.Header.Add("x-partner-id", "6c57db4e-9e11-4951-9bcf-d6f177dafbcc")
  req.Header.Add("channel-id", " 23412")
  req.Header.Add("x-external-id", "2024-05-15T06:57:04.004Z")
  req.Header.Add("Content-Type", " application/json")
  req.Header.Add("Authorization", "Bearer 6430fe8b-79d5-4e58-a337-6eb498e117a5")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

Response

Parameter	Tipe Data	Deskripsi
responseCode	String	Kode response
responseMessage	String	Pesan response
additionalInfo	Array Of Object	Informasi tambahan.
nama_bank	String	Nama bank
code_bank	Integer	Kode bank
icon_url	String	icon bank

{
    "responseCode": "2004300",
    "responseMessage": "Successful",
    "additionalInfo": [
        {
            "id_bank": 8,
            "nama_bank": "Bank BCA",
            "kode_bank": "014",
            "swift_code": "CENAIDJA",
            "city": "JAKARTA",
            "icon_url": "https://static-gc2.bebasbayar.com/android/bank/bank-bca.png",
            "is_bifast": 1,
            "urutan": "000"
        },
        {
            "id_bank": 5,
            "nama_bank": "Bank BNI",
            "kode_bank": "009",
            "swift_code": "BNINIDJA",
            "city": "JAKARTA",
            "icon_url": "https://static-gc2.bebasbayar.com/android/bank/bni.png",
            "is_bifast": 1,
            "urutan": "000"
        },
        {
            "id_bank": 2,
            "nama_bank": "Bank BRI",
            "kode_bank": "002",
            "swift_code": "BRINIDJA",
            "city": "JAKARTA",
            "icon_url": "https://static-gc2.bebasbayar.com/android/bank/bri.png",
            "is_bifast": 1,
            "urutan": "000"
        },
        {
            "id_bank": 4,
            "nama_bank": "Bank Mandiri",
            "kode_bank": "008",
            "swift_code": "BMRIIDJASTL",
            "city": "JAKARTA",
            "icon_url": "https://static-gc2.bebasbayar.com/android/bank/bank-mandiri.png",
            "is_bifast": 1,
            "urutan": "000"
        },
    ]
}

List Response Code

Response Code	Response Message	Description
2004300	Success
4004301	Invalid field format { field name }
4014300	Unauthorized. Invalid Signature	X-Signature salah
4094300	Cannot use same X-EXTERNAL-ID in same day	X-External-ID sudah pernah digunakan di hari yang sama
4044301	Bad Request	Request header ada yang salah / kurang
4044300	Unauthorized. Client Forbidden Access API	Partner tidak dapat mengakses api terkait
5004301	General Error	Terjadi kesalahan